home *** CD-ROM | disk | FTP | other *** search
/ Amiga News 95 / Amiga News 95.iso / dpat / dpat28 / multi_player / multi_player.doc < prev    next >
Text File  |  1992-09-11  |  9KB  |  298 lines
  1.  
  2.  
  3.    MULTI_PLAYER
  4.  
  5.    Version   2.0
  6.  
  7. New features since v1.2:
  8.     - ARexx support 
  9.     - start as a background start.
  10.     - Med replay
  11.        - better look !
  12.  
  13. contents:
  14.    1. General overview
  15.  
  16.    2. Usage
  17.  
  18.    3. Modify the programm
  19.  
  20.    4. Arexx or other programm interface
  21.    
  22.    5. History
  23.  
  24.    6. Copyright information
  25.  
  26.  
  27.    #########################
  28.    #  1. GENERAL OVERVIEW  #
  29.    #########################
  30.  
  31.    This programm tries to make only one workbench-replayer instead of ten...
  32. For example an intuitracker, a jamcracker replay...and so on!
  33.    But, before finishing this project the 'NoisePlayer' appeared,
  34. Noiseplayer attempted to accomplish the same functions but was lacking in 
  35. some areas: The addition of new replayers was not possible and had an
  36. unnecessarily large window on-screen.
  37. With this in mind I have continued this project and will hopefully make
  38. this program as-good as or better that Noiseplayer...
  39. Source will be available in public domain, so everybody can add their own
  40. replayer routines. See end to see how this is done.
  41.  
  42.    Features:
  43.  
  44.    - Use req.library
  45.  
  46.    - Support:
  47.          Soundtracker (but not the earlier ones)
  48.          Noisetracker
  49.          Protracker
  50.          Startrekker (include AM and FM modules)
  51.      MED3.0 (and Less?)
  52.          Jamcracker
  53.          Soundmonitor
  54.          FutureCOmposer
  55.          Delta
  56.          TFMX
  57.          Sidmon (bugmon?)
  58.      Noisetracked Packed
  59.  
  60.    - Can load crunched modules with powerpacker
  61.  
  62.    - Can be used "automatically" to start different song, without any
  63.      action of the user. Nice for slideshows (or musicshows)
  64.  
  65.    - Can be iconified
  66.  
  67.    - Little window!
  68.  
  69.    - Uses timer for replay, so it must work even on NTSC!
  70.  
  71.    - "Real amiga program", this means: correct use of workbench(read on)
  72.  
  73.    - AREXX port! So now you can programm the player without any action of the
  74. user!!!
  75.  
  76.    - Start as a background task
  77.  
  78. Note: there is no continuous (loop)play, because it is difficult to check
  79. when the module is finished with all the different replayers (i.e. Delta).
  80. There is the same problem when trying to incorporate VU meters, so no extra
  81. Controls...
  82.  
  83.    #########################
  84.    #   2.USAGE             #
  85.    #########################
  86.  
  87.    From cli: 
  88.    ---------
  89.  
  90.       multi_player [-w] [-r] [-s#] [-i] [song_name] [?]
  91.  
  92.       Just type multi_player and the requester will appear.
  93.       Or Typing multi_player <song name> will start the named song
  94.       In this case, press the both mousebuttons to stop playing.
  95.  
  96.     Options:
  97.  
  98.     -w:    Do not open the window where the gadgets are
  99.     -r:    Do not request for a song after the window is open
  100.                      (but open the window anyway)
  101.     -s#:    Determine the way to stop the song, if the window is not open.
  102.         ( the default is 4!)
  103.         if #=1  -> Press the left mousebutton to stop
  104.         if #=2  -> Press the right mousebutton to stop
  105.         if #=3  -> Press the both  mousebuttons to stop
  106.         if #=4  -> Press the left amiga + cntrl to stop
  107.         if #=5  -> No way to stop! (except using ARexx or cmd_player)
  108.  
  109.     Just type Multi_Player ? for short infos
  110.  
  111.    From Workbench:
  112.    ---------------
  113.  
  114.        just click on the icon and the requester will apears.
  115.  
  116.       But, you can also do multi-selection:
  117.  
  118.       - Press <shift> AND Click on one or more icons of the songs
  119.       that you want to play, and finally on the multi_player icon.
  120.       - If the default tool of the icon is c:multi_player, just
  121.       click on it! 
  122.       And in the both cases, juste click on the both mousebuttons
  123.       to stop.
  124.  
  125. If there is no songname specifed, a filerequester will appear, choose one
  126. module to load.
  127.  
  128.    After choosing a file, ( or clicking CANCEL), a window will appear,
  129. containing four buttons:
  130.  
  131.    '-': to iconify the window -> just click on the window to re-open
  132.    'STOP/START': if a song was playing, this stop the song. Press once
  133.     again to start it again.
  134.    'NEW':  to choose a new module to play
  135.    '?'  : to get some information on:
  136.           the current module.
  137.           Version of the programm.
  138.           Name of the module,size and type of replay used.
  139.  
  140.    If you try to choose an unknown type of module, the programm will
  141. continue playing the previous one (if one exists).
  142.  
  143. NOTES:
  144.  1) When you use TFMX modules, you can press keys 1-0 for different songs,
  145. but only when you load it using the requester.
  146.  
  147.  2) AM startrecker need two files: <songname> and <songename.NT>. If
  148. the second one is missing, the song won't start! 
  149. It's the same with TFMX, there must be two files: <mdat.songname> (the
  150. song data?) and <smpl.songname> (the samples?). If one file is missing,
  151. the song wont start!
  152.  
  153.  
  154.    #########################################
  155.    #   3.ADDING OTHER PLAYROUTINES         #
  156.    #########################################
  157.  
  158.     The source is no more in this disk, but you can have it by sending
  159. me a disk at the adress below.
  160.  
  161.    ##############################################
  162.    # 4. ARexx and other languages interface     #
  163.    ##############################################
  164.  
  165.    You can read this, even if you don't use ARexx, or if you are not a
  166. programmer but only a CLI user, because there is a progamm named "cmd_player"
  167. who allow you to give direct commands to the player!
  168.  
  169. 1) ARexx interface:
  170. -------------------
  171.  
  172.     I don't want to explain you what is ARexx, I'll just tell you how
  173. to use this programm (multi_player) from AREXX:
  174.     The name of the ARexx port is "Multi_Player"
  175.     The commands are: "Play" <songname>-> play a song
  176.             : "Stop"        -> stop the currently played song
  177.             : "Start"       -> restart a previously played song
  178.             : "Select" <number>-> select a tune. Only with TFMX
  179.                : "Quit"       -> quit multi_player
  180.  
  181. Note: all the command must be type exactly with the same caracter than
  182. before!
  183.  
  184. 2)Using cmd_player
  185. ------------------
  186.  
  187.     If you don't have ARexx, you can alos use the possibilities of
  188. multi_player. The programm cmd_player, in this disk, allow you to give
  189. an arexx command to multi_player.
  190.     The syntax is: cmd_player <arexx command to multi_player>
  191.  
  192.     Example:
  193.  
  194.     cmd_player    "Play df0:modules/modules-st/mod.piano"
  195.  
  196.     cmd_player    "Stop"
  197.     cmd_player    "Start"
  198.     cmd_player    "Select 1"
  199.     cmd_player    "Quit"
  200.  
  201.     All these command can be put in a script file!
  202.  
  203. 3)In C or GFABasic.
  204.  
  205.     You can access directly to the ARexx port of mulyi_player. It's
  206. very easy to give hime a command! Jus look at the programm in the example
  207. directory. You have the procedure named send_cmd wich allow you to send
  208. a message to the player. Juste use-it like this:
  209.     
  210.     send_cmd("Play modules/mod.song");
  211.  
  212.     So, you can use this player in your games....you don;t have to include 
  213. any specific replayer in your code. This one handle a lot of different
  214. kind of musi-program, and you can have in one programm different kinds
  215. of tunes: some from soundtracker, som from TFMX,etc....
  216.     Look at the examples on this disk!
  217.  
  218.    #########################
  219.    #   5.HISTORY           #
  220.    #########################
  221.  
  222.  
  223. Version 1.0 (31/03/91):
  224.    Many modules can be replayed.
  225.    Maybe a memory error with soundtracker modules? Very strange and
  226.    hard to find!
  227.    The c.o startup code of lattice always opens a window when you
  228.    start from workbench...I'll do my own c.o code, but for the moment
  229.    I patch the size of the window using zap (beurk!).
  230.  
  231. Version 1.1 (04/04/91)
  232.    I've used the req.library requester instead of the arp.library.
  233.  
  234. Version 1.2 (25/05/91)
  235.    Own c.o code. No debug window if open from workbench.
  236.    Bug fixed witch the CIA. Now work on WB2.0
  237.    New replay added: Noisetracker packed!
  238.    New you can start a new multi_player without exiting another one.
  239.  
  240. Version 1.3 (10/06/91)
  241.    Background startup (using a modified cback.a )
  242.    ARexx interface added
  243.  
  244. Version 1.4 (10/07/91)
  245.    MED Player Added
  246.  
  247. Version 1.5 (02/01/92)
  248.    Minor bugs removed
  249.    Added the start/stop gadget
  250.    "3D Gadget" buttons.
  251.  
  252. Version 1.6 (12/04/92)
  253.    Waoow...I see that there is more than one year since the beginning of
  254.    this history....time spend so fast
  255.    Instrument name are now written in the information window,
  256.    but only with protracker/soundtracker/startrekker modules
  257.  
  258. Version 2.0 (01/08/92)
  259.    Audio channels are now allocated!!!
  260.    But there are major bugs using workbench 2.0 with different fonts than
  261.    Topaz 8. Not yet solved....I find an easy way to do it, if someone have
  262.    an idea!
  263.  
  264.    ############################
  265.    # 6. Copyright information #
  266.    ############################
  267.  
  268.    This programm is freeware and can not be used for commercial purposes.
  269. If you want to distribue it, you must keep this document intact and with
  270. the programm.
  271.    If you have any suggestions, remarks about this programm or maybe you
  272. have discovered a bug the you can write to:
  273.  
  274.    Thomas LANDSPURG
  275.    9, Rue Baldung-Grien
  276.    67000 STRASBOURG
  277.    FRANCE
  278.  
  279.  
  280.    NOTE: the songs in the distribution disk came from various sources,
  281. but I don't now the name of all the authors! 
  282.  
  283. I must greet:
  284.  
  285.    Francois NICO for doing some very good programms
  286.    Flynn/TRISTAR for his great noiseplayer
  287.    Martyn of UGA (and of course RON) for the great NewsFlash mag..
  288.    F.Nico for his grat powerpacker.
  289.    Han Solo/CONCEPT for giving me the new demos!
  290.    F.Fleuret/E.Brunet
  291.    Darren Lambourne for his cool music (and for helping me with English!).
  292.    Skrew for his nices Icons!!!
  293.    Johan "Max" Karlborg for his remarks.
  294.  
  295.  
  296.  
  297.    The Amiga for being the best computer at this price!!
  298.